Agentes de IA
Um Agente é a persona de IA que atende suas chamadas de voz e conversas de WhatsApp. Ele é criado e gerenciado em Agentes de IA no painel administrativo.
Dados do agente
Ao criar ou editar um agente, os seguintes campos estão disponíveis:
| Campo | Descrição |
|---|---|
| Avatar | Imagem exibida no painel e na listagem de agentes. |
| Nome | Identifica o agente. |
| Descrição | Breve resumo sobre o propósito do agente. |
| Instruções (Prompt do Sistema) | Texto que define o comportamento, tom e regras de atuação do agente. É o campo mais importante — obrigatório. |
| Conexão de IA | Qual conexão de IA o agente usa para processar a conversa. Pode ser criada na hora, direto no formulário do agente. |
| Voz | Voz sintética usada nas respostas. marin e cedar são as recomendadas; também estão disponíveis alloy, ash, ballad, coral, echo, sage, shimmer e verse. |
| Ativo | Controla se o agente pode receber chamadas/mensagens. |
Ferramentas (Tools)
Cada agente pode ter ferramentas (tools) que estendem o que ele consegue fazer durante uma conversa. Elas são gerenciadas na aba Tools, dentro do próprio agente.
Tipos de ferramenta configuráveis:
- Busca (
search) — pesquisa na web usando Google, Bing ou DuckDuckGo, com limite de resultados. - MCP (
mcp) — conecta o agente a um servidor MCP externo (nome, URL e token de autenticação). - API REST (
api_rest) — chama um endpoint HTTP (URL, método, tipo de autenticação — nenhuma, bearer, basic ou API key — e headers customizados). - Banco de dados (
database) — executa uma consulta SQL fixa em um banco externo (MySQL, PostgreSQL ou SQL Server). - Ação de contexto (
context_action) — dispara um webhook quando uma condição descrita em texto acontece na conversa, podendo enviar variáveis extraídas do diálogo (nome, chave, tipo e se é obrigatória).
Essas cinco aparecem para o modelo como ações que ele pode decidir chamar durante a conversa.
Já as ferramentas abaixo não são ações invocáveis — em vez disso, elas mudam automaticamente o comportamento do agente (a saudação inicial ou as próprias instruções). Todo agente novo já nasce com uma de cada, ativa e com um valor padrão, mas você pode editar o conteúdo:
- Primeira Mensagem (
first_message) — texto usado para abrir a ligação antes do usuário falar. - Indagação e Esclarecimento (
clarification_rule) — regra anexada às instruções do agente, orientando-o a perguntar em vez de adivinhar quando a intenção do usuário não estiver clara.
Além dessas, todo agente novo recebe automaticamente três ferramentas automáticas sem nenhum campo de configuração:
- Transferir Ligação — transfere a chamada para um atendimento humano.
- Transferir para Outro Agente — passa a conversa para outro agente de IA.
- Agendar Compromisso — cria um evento na agenda.
Testando o agente
Na tela de edição do agente existe a ação Testar Agente, que abre uma chamada de voz via WebRTC direto no navegador, usando o modelo realtime configurado — útil para validar o prompt e a voz antes de colocar o agente em produção.
Próximo passo
Depois de criar o agente, conecte-o a um canal em SIP (telefonia) ou WhatsApp, e conheça as ferramentas disponíveis que ele pode usar durante uma conversa.